home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Info / For Developers / InstallerMaker™ 4.0 Installer / Customizing InstallerMaker / Sample Code / E-Z ILoc ƒ / E-Z ILoc Directions next >
Text File  |  1997-05-12  |  4KB  |  35 lines
  1. E-Z ILoc and the E-Z ILoc Editor
  2.  
  3. An 'ILoc' extension is an InstallerMaker extension that is used to define Destinations on the Destination menu.  Many standard Destinations are supported by InstallerMaker, but there are times when you may want to create your own Destinations, and you will need your own 'ILoc' extension to do this.
  4.  
  5. The original intent of this code example was to make an 'ILoc' shell, which anyone could modify easily with ResEdit.  The code is designed to read a path name, as demonstrated below, from a 'STR#' resource.  Modifying a 'STR#' resource is very easy to do, unfortunately the resource ID of the 'STR#" resource must be a constant in the code, the end result being that only one E-Z ILoc could work in an installer, because there could only be one identified path name.
  6.  
  7. Solution:  Every 'ILoc' extension must have a unique ID.  The E-Z ILoc Editor will create a 'STR#' resource with the unique resource ID number you choose for your 'ILoc', then modify the 'ILoc' extension to look for that unique ID number, allowing you to have unique path names for each 'ILoc' you create so you can use more than one in your installer.  You could make these kinds of changes yourself by finding the right offset in the 'ILoc' and replacing the right bytes with the correct hex value matching the ID, but that is not easy or convenient.
  8.  
  9. How To Use The E-Z ILoc Editor
  10.  
  11. 1. First make a copy of the E-Z ILoc, name the copy appropriately to identify it as the ILoc created for the Destination you have in mind, then drop the file onto the E-Z ILoc editor.
  12.  
  13. 2. The heart of your ILoc is what is called a path name.  A full path name includes the name of the hard drive (or volume) at the beginning.
  14.  
  15. Example -  Macintosh HD:Applications:Internet Applications
  16.  
  17. A partial path name may be entered into the path name field of the E-Z ILoc Editor.  The name of the volume will then be set to the default volume (the startup disk) for you.  Below is an example partial path name leading to a subfolder named Internet Applications, located within a folder named Applications, located in the root folder of the default volume.
  18.  
  19. Example -  :Applications:Internet Applications
  20.  
  21. 3. Enter a name in the appropriate field that you want InstallerMaker to display on the Destination menu for your ILoc.  You will probably want to use the same name that you chose for the file.
  22.  
  23. 4. Every ILoc may have a corresponding icon displayed on the Destination menu.  You may copy and paste your own icon or picture into the E-Z ILoc Editor to give your custom ILoc destination its own icon.
  24.  
  25. 5. Your ILoc must have a unique resource ID.  ILoc resource ID numbers should fall between -32767 and -6000.  Choose an ID number for your ILoc within that range and enter it in the appropriate field in the E-Z ILoc Editor.  If you find that the number you choose conflicts with another ILoc, drop your ILoc on the E-Z ILoc Editor and select a new ID number.
  26.  
  27. 6. When everything is set the way you want it, save your new ILoc.  Give it an appropriate file name, then open up the Locations folder in the folder with InstallerMaker and drop in your new ILoc.  If InstallerMaker is running when you drop in your new ILoc, you will need to Quit InstallerMaker and relaunch it, in order for it to recognize your new ILoc and place it onto the Destination menu.
  28.  
  29. THAT'S IT!
  30. You're ready to use your new custom location!
  31.  
  32. Programmers note: The sources for the E-Z ILoc are included in the Sample Code folder, in the Customizing InstallerMaker folder, in the folder with InstallerMaker.  You may find it as a helpful example in creating ILoc extensions with more specialized control (i.e. using FindFolder to locate standard OS folders as the first part of the path, rather than relying on a single-language's path string.).  The E-Z ILoc is able to create missing directories in a path, which is a nice feature you may want to build into your own ILoc.  The code is commented and you are free to use it according to the guidelines established in the comments.
  33.  
  34. Copyright 1997  Aladdin Systems, Inc.
  35.